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PLEASE NOTE: 


ALL REFERENCES TO REV 3.09 APPLY TO REV 3.011 
ALL REFERENCES TO REV 3.13 APPLY TO REV 3.16 


THE MANUAL FILES FOR MYDOS ARE: MYDOS.DOC (REV 3.011) 
ATR8000.DOC (REV 3.16) 
MYDOS.IDX (REV 3.16) 


TO COPY THESE FILES TO THE PRINTER, USE THE COPY (C) OPTION. 


(IF YOU HAVE A SERIAL PRINTER, YOU MUST RUN THE PROGRAM SERDRV.BAS 
UNDER ATARI BASIC FIRST, THEN) 


TYPE, Cy <THEN, TYPE MYDOS SDO0G,.P': 


TO COPY THESE FILES TO THE SCREEN, USE THE COPY (C) OPTION 
TYPE C, THEN TYPE MYDOS.DOC,E: 


IF YOUR DISTRIBUTION COPY OF MYDOS HAS REV 3.16 LOCATED ON’ THE 
BACK SIDE OF THE DISK, YOU MUST FIRST BOOT THE FRONT SIDE OF THE 
DISK(REV 3.011), THEN FLIP THE DISKETTE OVER, TURN THE ATARI 
(ONLY) OFF, AND TURN THE ATARI ON. PLEASE MAKE WORKING COPIES OF 
BOTH SIDES OF THE DISKETTE, AND STORE THE DISTRIBUTION MASTER IN 
A SAFE PLACE. THIS IS FOR YOUR PROTECTION, AS THERE IS A_ $10 
CHARGE TO FIX A CRASHED DISKETTE. THE SAME $10 FEE ALSO APPLIES 
TO FUTURE UPDATES. 
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1. INTRODUCTION 


The two disk operating systems described in this manual are 
identical in usage and share common code for nearly all 
functions. The only significant difference a user of the MYDOS 
and ROMDOS operating systems will. notice is that the ROMDOS 
version will occupy significantly less memory (larger files may 
be edited, larger BASIC programs may be run, and some assembly 
language programs might run that would not otherwise). Both are 
modeled after the ATARI (trademark of Warner Communications, 
Inc.) disk operating systems (DOS and DOS II) and may be 
considered an extension of the very “user friendly" concepts 
introduced with those two operating systems. For this reason the 
two DOSs documented here are identified as MYDOS 3.0 and ROMDOS 
3.0. The ATARI 810 disk drive is well supported by the DOS II 
operating system, but DOS II has only limited provision for a 
double density disk system (the ATARI 815 dual drive system), and 
no provision at all for a system that could change density 
dynamically (a "dual" density system). Since dual density 
systems have now been manufactured for some time for the ATARI, 
and there does not appear to be an easy to use system to take 
full advantage of such a drive, WORDMARK Systems has developed a 
disk operating system to allow for dynamic density changes and 
larger capacity diskettes even in a Single drive configuration. 


2. SYSTEM REQUIREMENTS 


The ROMDOS 3.0 operating system requires 8K of RAM and 
either the Newell Industries RAMROD board for the ATARI 800 or 
the CDY adapter board for the ATARI 400 or 800 computers. MYDOS 
3.0 requires 16K of RAM (provided by most 400, and all 800 or XL 
series computers). Both versions require one ATARI 810 
compatible disk drive or disk controller. In addition, if the 
dynamic density selection is used, the controller must provide 
the extended 810 interface described in Section 10. This 
extended interface is supported by the PERCOM dual density disk 
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subsystems, the ATR8000 disk/printer/RS232 controller 
manufactured by SWP, Inc., and the Amdek 3" Microfloppy systen. 


Up to eight disk drives may be accessed, but only one is 
required. The resident part of the operating systems (even the 
RAM resident MYDOS 3.0) leaves more free memory than the ATARI 
DOS, DOS II or DOS 3 do. MYDOS and ROMDOS also support all 
documented functions of the DOS II operating system, so MYDOS 3.0 
and ROMDOS 3.0 support most available software for the ATARI home 
computers. The BASIC and Assembler/Editor Cartridges both take 
advantage of the added memory available, and APX Pascal, the Deep 
Blue C Compiler, OSS BASIC A+, MEDIT and the AMAC macro assembler 
all run from double density disks with no alterations or 
limitations. ATARI BASIC has over 32,400 bytes left in a 40K 
system, even with eight double density disk drives configured. 
The memory occupied by the permanently resident part of MYDOS is 
$0700 to $1C80 and that part occupied by the utility program 
exchanged with the MEM.SAV file extends to $3300. If a program 
with an execution entry point is loaded into the area between 
$1C80 and $3300 it will run exactly as it would if loaded above 
$3300. However, if the program is to be patched or run manually 
with the 'M' command, it must be loaded into MEM.SAV using the 
'N' command: if not, the menu program will be loaded back into 
memory on top of it before it can be used! 


The memory available to a program is affected only by the 
number of files to be open concurrently: each disk file that may 
be open at the same time requires 256 bytes of buffer space. 
Memory requirements are independent of the number of disk drives 
or the sector size (density). 


3. MENU FUNCTIONS 


The menu provided by MYDOS 3.0 identifies 18 common tasks 
that might need to be done. Rather than having to write a utility 
program (only a few lines of BASIC would perform most of the menu 
functions) or even remember the name and format of a DOS command, 
these tasks can be handled by entering a single letter. MYDOS 3.0 
responds with a question asking for the details of the operation 
(which file, what density, "are you sure?" or whatever else it 
might need to know). After you enter the remaining information, 
the function is performed and another prompt is displayed. 


You should notice two interesting things about the menu: the 
second line on the screen identifies the disk drives present on 
the system and what they appear to MYDOS 3.0 to be (single or 
double density). The next line describes the current default 
directory (that directory used when a disk is referenced by ee 
(without a unit number after the 'D'). The second thing to 
notice is that after commands fill the screen, the menu 'rolls' 
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off the top: some DOS programs keep the menu, MYDOS 3.0 does not..- 
This permits more information to be shown on the screen when a 
long sequence of commands is needed to perform a function or when 
a directory is being listed or several files are being copied. 
To restore the menu to the screen, just type RETURN and the 
initial screen is restored. 


Some commands require further information to prevent 
accidental damage to your disk files: the 'I' command and the 'J' 
command both require confirmation (through an additional key 
entry) before distroying the destination disk. To abort either 
operation without damaging any existing disk files, simply press 
RESET or BREAK. The 'D', 'E', 'F' and 'G' commands (delete, 
rename, lock and unlock) all require an explicit file 
specification. All other commands assume the drive containing 
the default directory or all the files in the default directory 
(depending on whether the command affects an entire drive or a 
set of files). : 


Disk drive specifications and file specifications are made 
using the same rules: if only a drive is specified and file data 
is required, all files on that drive (or in the case of the 'K' 
'L' and 'N' commands to save and load programs, the first file on 


that drive) will be the assumed choice. A drive is specified 
with a ':' (meaning the default drive), a number (with or without 
a trailing ':') or the capital letter 'D' followed by an optional 


number and a required ':'. If you wish to specify the file or 
set of files to be referenced, the drive format must include a 
':' or it must be omitted entirely -- Di:Test.obj, 1:TEST.ASM, or 
D2TEST (really D1:D2TEST) are valid file names, but d1:Test.obj 
or 1TEST.ASM are not. 


The file name itself is either fully specified (refering to 
exactly one file on the disk) or includes wild cards (specifying 
a set of zero or more files). A fully “specified file name 
consists of one to eight characters followed by a period ('.') 
and zero to three additional characters. The first character in 
the file name must be an upper or lower case letter, an 
underscore (' ') or the characters '@' or '~'. The ‘'~' is the 
ATARI diamond graphic. The remaining character may be in that 
set or one of the digits 0-9. The ‘wild card' characters are the 


characters '‘'*' and '?': the character '*' or the sequence '*.' 
end either the 8 character or the 3 character field in the file 
name and match all possible characters. The character '?' 


matches any Single file name character. 


In addition to the main directory (containing up to 64 files 
or directories) each MYDOS 3.0 disk may also contain additional 
directories of 64 files each. If the main directory contained 
the directory file BAS and the file GRAPHIC1 were in the 
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directory file BAS, it could be referenced with the filename, 
BAS:GRAPHIC1. If instead, GRAPHIC1 were in the directory GR.dir 
which in turn were in BAS, then the reference would be to 
BAS:GR.dir:GRAPHIC1 (and so on with as many names as needed). 
Because there is no limit to the number of directories on a disk 
(other than the buffer size of programs using the directories and 
number of available sectors on the disk), a single diskette can 
contain hundreds of files if necessary. Each directory is 
limited to 64 files or subdirectories though. 


If a disk directory includes the files TEST.ASM, TEST.OBJ, 
TEST.C, TEST.ALM, TEASET.DOC, TRACE.FIL, and BETS.LST, the 
specification. "t*.*"*-will-not match any file name (since "t" and 
"I" are not the same letter to MYDOS 3.0). The specification 
"T**" will match all but "BETS.LST" (since the others all begin 
with the letter "T"). The specification "?E??.*" will match the 
first four files and the last one (since the 8 character part «of 
the file name must have 4 characters in it and the second must be 
an "E"). The specification "*?" will match only the file TEST.C 
(since it is the only file name with.a Single character in the 3 
character field). The specification "?9??7?E**" will match the 
files TEASET.DOC and TRACE.FIL and none of the others (since the 
8 character part of the file name must have at least 5 characters 
and the fifth must be an "E"). 


Where more than one file name is asked for, the first may be 
omitted by starting the response with a space or comma, and the 
last may be omitted by ending the line with a comma (the space 
cannot be used here since trailing spaces are ignored). If both 
file names are entered, they may be separated with either a space 
or a comma. Some commands may be modified using a letter 
following the character '/' after the fil@ name (for example, 1/A 
or D1i:TEST/A). The letter used (the modifier) generally means 
the same thing if it is allowed. Invalid modifiers are always 
ignored with no error indication at all. The modifier '/A' 
causes the results to be appended to the end of an existing file. 
This is applicable to 'C' (copy) and 'A' (directory) commands. 
The modifier '/N' causes the destination disk formatting to be 
skipped (saving about a minute) when used in the 'I' (initialize) 
and 'J' (duplicate disk) commands. It prevents the questions 
asked before changing each file if it is used in the 'D' 
(delete), 'F' (lock) and 'G' (unlock) commands; so we bend the 
rule only recently mentioned. In both cases, part of the 
function is skipped (see?). The '/X' command causes MYDOS 3.0 to 
pause at the end of each read or write pass when copying data to 
allow you to change disks (permitting you to copy from one disk 
to another with a single drive, even if that drive appears to 
MYDOS 3.0 to be two drives). This option supports disk drive 
that handle increased capacity by making a single diskette appear 
to be on more than one drive at a time, as well as disk drives 
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that select density through the drive number (1-4 are single 
density, 5-8 are double, for example, and drives 1 and 5-are © the 
same physically). This also allows the writing of a directory of 
one disk onto another as a file (use the command 'A' followed by 
the entry "1,1:DRVO1.dir/X") even with only a single drive on the 
system. The '/X' is assumed if only one file name is entered in 
the copy command. This emulates the operation of the ATARI DOS 
II 'O' command which is not implemented in MYDOS 3.0. 


To omit copying files with extensions beginning with 'S', 
the '/S' modifier can be appended to the source specification in 
the 'C' (copy) command: for example, the line "2/S,1" will copy 
all files not matching the string *.S?? from drive 2 to drive 1. 


4. THE MENU COMMANDS 
4.1 A. List a Directory or a Set of Files 


The 'A' command will list the files on a disk with their 
sizes, followed by a line specifying the number of free sectors 
on the disk. If the line starts with an '*', the file has been 
locked and may not be modified or deleted without first being 


unlocked. A ':' before the file name marks those files that are 
directories. These files cannot be read or written as other 


files but only accessed as directories. No indication is made of 
the format of the file (ATARI DOS, ATARI DOS II, or MYDOS 3.0 are 
the three supported file formats). See Section 6 for further 
information if you need more information about the files than the 
'A' command provides. This command will list the directory 
information to the screen if only one file specification is 
entered. If two are entered, the second is taken as a destination 
file and will be overwritten (or appended to) with the directory 
data: the entry "1,P:" will write the directory of the disk on 
drive 1 to the printer, for example. 


To list the files in a subdirectory, enter the name of the 
directory followed by the symbol ':'. For example, N4-SPEOT SBR: " 
will list the files in the directory BAS which in turn is in the 
directory TEST in the main diskette directory. 


4.2 B. Run the Cartridge 


The 'B' command returns control to the cartridge in the 
first cartridge slot. If no cartridge is present, an error is 
displayed, and nothing happens. No additional information is 
required, so if a cartridge is present it is entered after 
loading MEM.SAV (if the last load command was an 'N') or 
immediately (if the last load command was an ey 
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4.3° ©. Copy a File or a Set of Fites 


The 'C' command is used to make another copy of one or more 


files of data. The two file specifications asked for after 
entering the 'C' identify the source and the destination of the 
information being copied. Either may be fully specified disk 


file or a device specification (such as E:, P: or one of the 
RS232 ports R1: to R4:). The destination may be a set of disk 
files (specified with '*' and '?'s) only if the source specifies 
a file name for the destination to use. Copies from a file set 
to a device will implicitly write consecutive files to the device 
(generating a set of listings or a collection of cassette files 
for example). The source may be a set and the destination a 
single disk file, but unless the '/A' modifier is specified to 
append each copied file to the end of the previously copied 
files, only the last source file will remain on the destination 
disk. 


Note that the 'C' command always uses the full memory space 
for a copy operation (unlike ATARI DOS II) and as a result, will 
always invalidate MEM.SAV if it is used. Any pending program 
cannot be restarted after a 'C' or 'dJ' command. 


4.4 D. Delete a File or Set of Files 


The 'D' command will remove all files that match the file 
specification entered asking for confirmation before each one is 
removed. This verification that the file is really the one to be 
removed can be disabled for the duration of this single 'D' 
command by adding the command modifier '/N' to the end of the 
file specification. In this case, all the matching files will be 
removed 'quietly' and the only further indication you will see is 
the prompt for the next command. 


4.5 E. Rename a File or Set of Files 


The 'E' command changes the name of the source file or files 
to match the specification in the destination. Unlike other file 
specifications, the destination specification must consist of a 
Single file name: it must not contain any directory names or a 
disk drive specification. For example, 
"D2:TEST: BASIC: NOTPNT.BAS,RANDIO.BAS" is the line entered to 
change the name of a file in the directory "D2:TEST:BASIC". To 
change the name of the directory "BASIC" to "ATBASIC", the line 
would look like "D2:TEST:BASIC,ATBASIC". 
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4.6 F. Lock a File or Set of Files 


The 'F' command limits access to the files identified. The 
files may not be deleted, renamed, added to or replaced without 
being first unlocked with the 'G' command. When a directory is 
listed, the files that have been locked using either the 'F'! 
command or the ‘lock' or ‘open locked' functions provided through 
CIO will be marked with an '*' in the first column. The files 
that are locked may be read or loaded and executed normally, only 
modification or removal are prohibited. 


Before each file is locked MYDOS asks you for confirmation 
with a message: for the file TEST, the message would read "Lock 
TEST?". Any answer but 'Y' will result in the file not being 
locked. The confirmation questions can be skipped by adding '/N' 
to the end of the file specification. 


4.7 G. Unlock a File or Set of Files 


The 'G' command removes the limitations imposed on a file 
when it is 'locked' using the 'F' command. It does not alter the 
file or otherwise change the way the file is accessed or used. 
The same function may be performed in a program through the CIO 
function to ‘unlock' a file. 


Before unlocking each file MYDOS asks for confirmation with 
a question that must be answered with a 'Y' if the file is to be 
unlocked; otherwise, no action is taken and the next confirmation 
question is asked. To disable the confirmation questions, enter 
'/N' after the file specification (see Section 4.4, on deleting 
files, for a more detailed explanation). 


4.8 H. Write MYDOS 3.0 to a Disk 


The 'H' command is used to make a rebootable copy of the 
current MYDOS 3.0 files in memory. The two files created or 
rewritten are 'DOS.SYS' and 'Dup.SYS'. 'DOS.SYS' is an image of 
the permanently resident file management routine accessed through 
CIO and the small interface package that loads and saves MEM.SAV 
(an image of the part of memory used to hold the nonresident part 
of MYDOS 3.0) and the second part of MYDOS 5.0 itself 


('Dup. SYS"). The file 'Dup.SYS' is a standard load file 
containing the part of MYDOS 3.0 that is overwritten when a 
program is loaded into memory. Neither of these files is 


compatible with any other disk operating system either for the 
ATARI or any other home computer. Both should be treated as a 
Single object. Never copy only DOS.SYS or only Dup.SYS to a disk 
without copying the other. The files written to the disk by the 
'H' command will reflect the configuration parameters currently 
in memory, which may be different from the ones active if the 
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system were rebooted from disk egain. (See Section 9 for the 
definition of the configuration parameters provided in the system 
and how to specify a modified configuration.) 


4.9 I. Initialize a Diskette 


The 'I' command is used to prepare a new disk for use with 
the MYDOS 3.0 operating system or to remove all the files on an 
old disk. The result of the 'I' command is a completely empty 
disk. The only data on the diskette is that system provided 
information defining the space available and the empty main 
directory. If the drive number is followed by a '/N' modifier, 
the diskette will not be reformatted, but just 'erased'. This is 
the recommended way to remove all the files on a diskette, rather 
than to use the 'D' command. 


4.10 J. Duplicate a Diskette 


The 'J' command copies all the information from one diskette 
to another. The information on the diskette is identified by the 
MYDOS 3.0 bit map (on the VTOC sectors) if no sector range is 
specified. If a range is specified, the data to be copied are 
the sectors in that range and the VTOC is not examined. 
Specifying a sector range is done by adding two numbers seperated 
by a dash and enclosed in parentheses to the end of the drive 
specification(s). For example, to copy sectors 19 through 54 
(tracks 1 through a from drive 1 to drive 3% the command line 
could be "1,3(19-54)". 


If the destination disk is already a properly formatted 
MYDOS 3.0 diskette, the '/N' modifier may be entered after either 
drive number to skip the formatting of the destination drive. 
Otherwise, the destination diskette will be formatted before the 
data from the source is copied to it. That is, either "1/N,2" or 
"4 ,2/N" will “copy° from®-drive 1 to drive 2 without first 
formatting the diskette in drive 2. To copy the first two tracks 
of a diskette without formatting the diskette being copied to, 
you could enter "1,2/N(1-36)" or "1 2/N(1-36)". 


Note that the 'J' command, like that in ATARI DOS II, will 
use all of available memory to duplicate the diskette: this means 
that if memory has been saved using the MEM.SAV file, it will no 
longer be valid. Any pending program cannot be restarted after a 
'C' or 'J' command. 


4.11 K. Save Memory to Disk 
The 'K' command builds a binary load file containing the 


data from the memory area specified, as well as an initialization 
and a run vector address if specified. If the file is not to 
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execute an initialization routine on being loaded, the 
initialization vector should be omitted. If it is not to run on 
being loaded, the run vector should also be omitted (and trailing 
commas need not be typed in either). If either vector is entered 
as zero, that vector will not be invoked when the program is 
loaded. Note that the Starting and ending addresses of the 
program and the initialization and run entry points of the 
program are all specified as hex numbers. 


If MEM.SAV is active when the 'K' command is entered, the 
MEM.SAV file is loaded before writing the file to the disk. 


4.12 lL. Load Memory from a File 


The 'L' command takes a binary load file from the disk and 
loads it into memory. The load file's initialization routine(s) 
will be executed and the program started at its run address 
unless the '/N' modifier is appended to the file name. This 
command disables the MEM.SAV file before loading and executing 
the program. ; 


4.13 M. Run at Address 


The 'M' command is used to enter a program loaded without a 
run address, or to jump into any program without the need for a 
return address. It may be used to restart the computer (loading 
the AUTORUN.SYS file, if any) by specifying $E477 as the jump 
address. If MEM.SAV is active (enabled with the 'N! command and 
not since disabled by the 'L' command), the contents of memory 
will be restored from MEM.SAV before jumping to the address 
specified. 


4.14 N. Load MEM.SAV from a File 


The 'L' command takes a binary load file from the disk and 
loads it into memory. The load file's initialization routine(s) 
will be executed and the program started at its run address 
unless the '/N' modifier is appended to the file name. This 
command enables the MEM.SAV file before loading and executing the 
program and when control is returned to MYDOS the contents of 
memory will be saved in MEM.SAV. 


If no file name is specified, the MEM.SAV file usage is 
enabled but no program is loaded or run. 


4.15 0. System and Drive Configuration 
The 'O' command is used to Specify the type (at least 


logically) of the disk drives on the ATARI computer. 
Additionally, it is used to Specify the number of file buffers 
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provided and to control verification after disk write operations. 
For owners of early production 80C and 400 computers with the 
ATARI A revision OS ROMs this command is used to disable the 
'fast write' algorithms that do not reliably work with those 
computers. Also, by disabling fast writes, code in ROMs may be 
written to disk (say to later be disassembled by any of several 
BASIC disassemblers). This is necessary since the fast write (or 
"Burst mode I/0" as referred to in ATARI and OSS documentation) 
operations modify the text buffer, then restore it, during a 
write and this is obviously not possible if the text is -in ROM. 
These three functions, which are not specific to individual 
drives, are selected by entering a RETURN when the prompt asking 
for a drive number is displayed. Three questions will then be 
asked: "Verify WRITEs" expects a 'Y' to be entered if all data 
written to the disk is to be read back to verify that it was not 
only written correctly, but that the data is in fact readable 
from the disk. The second question: "Number of File Buffers" 
expects a number, followed by a RETURN to specify the number of 
file buffers to be allocated. The third question, 'Fast WRITEs 
allowed?', should be answered 'Y' if the computer is an XL series 
computer or a 400 or 800 computer with the B-revision OS ROMs. 
If the computer is an early 400 or 800 computer with the A- 
revision ROMs the answer should be 'N' to disable the fast write 
algorithm because the A-revision ROMs do not allow the sector 
buffer to be located anywhere in memory. As mentioned above, 
answering 'N' will also permit SAVEing memory in the OS ROMS or 
in cartridges using the 'K' command. A RETURN does not retain 
the current value -- the result is YES as the answer to the 
"Verify WRITEs' question, and 3 buffers as the answer to the 
number of buffers question. Anything but a 'Y' will enable fast 
writes in response to the third question. 


If instead of a RETURN, a drive number or name had _ been 
specified then that drive would be reconfigured. The first 
question identifies whether the drive is to be included in system 
initialization (and thus be available for later use). If a non- 
existent disk is included it does not cause any problems with the 
system: it simply causes that disk to be examined each time the 
system is booted (adding perhaps a second to the time it takes to 
boot up MYDOS 3.0). If drive is excluded from the system, no 
further questions are asked. Otherwise, the second question asks 
if the drive is configurable: that is, is it like the ATARI 810 
or 815 drives (with a fixed configuration) or is it like the 
PERCOM or ATR80OO drives. If the disk is not configurable it is 
assumed to be a 720 sector, single or double density ATARI 81x 
disk drive. Drives excluded from the system can be dynamically 
added by referencing them but they will always be treated as 5 
1/4 inch 810 or 815 compatible drives (the default 
configuration). 
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If the first two answers are 'N' (do not exclude the drive) 
and 'Y' (it is configurable), the configuration is asked for: Is 
the drive double sided, how many tracks are there on the each 
side of the disk, and at what speed can it move the read/write 
head across the disk (what is its step rate). The first question 
is answered with 'Y' or 'N' ('Y' meaning 'yes' it is a double 
sided drive and diskettes formatted on it will be double sided). 
The second question is answered with 35, 40, or 80 followed by a 
RETURN if the disk drive is a 35 track, 40 track, or 80 track 5 
174 inch floppy drive and with 77 if the drive is a standard 77 
track 8 inch drive. No other number is accepted. The answer to 
this question specifies both the type of drive (8 inch or 5 1/4 
inch) as well as the number of tracks per inch and total capacity 
of the drive. This answer is very important to the operation of 
the drive. The last answer is entered as a code: use the 
following table and the drive specifications to determine the 
proper value. 


Code value 8 inch rate 5 1/4 inch rate 
0 3 ms/track 6 ms/track 
{ 6 ms/track 12 ms/track 
2 10 ms/track 20 ms/track 
3 15 ms/track 30 ms/track 


4.16 P. Diskette Density Selection 


The density used for most MYDOS commands is determined by 
the data written on the diskette and the operator need not worry 
about setting it. The 'P' command is provided to allow forcing 
the density setting for the format ('I') command and to permit 
setting the density before loading a program that does not 
automatically select the proper density (most programs do not). 


MYDOS commands that access a diskette will automatically 
select the appropriate density, so the 'P' command will have no 
effect on the drive if any command accessing the drive configured 
with the 'P' command is executed before the format ('I') command 
or the program is run (using the 'B', 'L' or 'N' commands). 


4.17 Q. Create Additional Directories 
When a diskette is formatted, an empty directory (the 


highest level or root directory) is created (empty). This 
directory is capable of holding up to 64 files or other 


directories. If additional directories are installed in this 
directory, each of the additional directories can contain up _ to 
64 files as well. A directory is installed in an existing 


directory using the 'Q' command and responding to the question of 
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what the directory name is with the name of the new directory. 
For example, if "TEST" and "BAS" are two directories in the root 
directory of the diskette in drive 1, "1:TEST:COMM" or 
"1:BAS:COMM" would both create a new directory in "TESTI" and 
"BAS" respectively. "4 :NEW:COMM" would not, however, since "NEW" 
does not already exist. A 'Q' command with the response "NEW" 
would create the first directory followed by an additional 'Q' 
command with the response "NEW:COMM" would create the two nested 
directories, though. 


Each directory takes up 8 sectors and after it is created it 
may only be referenced as a directory (folowed by a ':' that is) 
or deleted. It may only be deleted if it is empty (if it has no 
filge -in- 1%). A directory may be emptied by using the 'D' 
(delete) command and specifying the files "*.*/N" to remove all 
the files in the directory. 


4.18 R. Set the Default Directory 


The 'R' command is used to select a directory to be used 
when a file is referenced without the drive number: that is, when 
file names such as "TEST1.BAS" or "D:NEWCODE" or even ":BIGFILE" 
are used, they are assumed to be in the default directory. 
Programs run under MYDOS 3.0 can access the contents of the 
current default directory by using a file name of the form 
"Dz..." without the drive number explicitly entered. They may 
also set the default directory by calling the CIO Function code 
41 (set directory) routine. 


The directory is set by inserting the diskette with that 
directory on it into the desired drive, then entering the file 
name of the directory with no trailing ':'. 


If the diskette in the drive containing the default 
directory is replaced, the default should be redefined unless it 
is the root directory. This is because only the root directory 
is at the same location on all diskettes. 


5. FILE MANAGER FUNCTIONS PROVIDED THROUGH CIO 


MYDOS 3.0 supports all CIO calls supported by ATARI DOS II, 
with the following modifications to the OPEN (Function code 3) 
and the FORMAT (Function code 254) functions. Three additional 
CIO functions have been added: MAKE DIRECTORY (Function code 34), 
Ea DIRECTORY (Function code 41) and LOAD MEMORY (Function code 
39). 


The OPEN function in ATARI DOS II does not use the data 


provided in the AUX2 byte, but in MYDOS 3.0 the AUX2 byte 
contains three flags that control the file format and whether it 
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will be created locked or not when the AUX1 byte is 8 (the file 
is opened for creation or replacement). Lf-AUK2=bite=1 Sas “set, 
the file will be written in the ATARI DOS (original) format 
(unless the disk is double density: the original format is not 
viable for 256 byte sectors. When using double density disks, 
this bit is ignored). If AUX2 bit 2 is set, the file will be 
written in MYDOS 3.0 format, and may contain sectors beyond 
absolute sector 1023. Such a file may not (easily) be read using 
ATARI or OSS DOSs. Tf - AUK — bit =<-5-is= set, the-tate will be 
written with the 'LOCKED' bit in the directory set initially. 
This is provided for use by multi-tasking functions (such as a 
print spooler, sequential file pre-reading function or other 
enhancements one might want to make to the standard OS or DOS 
provided functions). 


The FORMAT function in ATARI DOS II does not provide for any 
variations to the standard disk usage: in MYDOS 3.0, the contents 
of the AUX1 and AUX2.bytes are used to specify the number of 
sectors on the disk being formatted and whether the disk needs to 
be formatted by the controller as well as needing directory 
initialization. Bit 7 of AUX1 is set to skip the physical 
formatting of the entire disk surface when it is not required, 
and bits 6-O of AUX1 and all of AUX2 are used to specify the 
number of sectors on the disk being created (if all 15 bits are 
zero, the disk is assumed to be a standard 720 sector disk). 


To load (and possibly execute) a program file, MYDOS 
provides the CIO function 39 call. From BASIC you can load and 
execute a program by executing the line: XIO 39, #3, 4, O, 
"D:MYPROG.OBJ". Any inactive IOCB can be used, and if AUX1=4 
both the INIT and the RUN entries will be executed. If AUX1=5, 
the RUN entry will be executed, if AUX1=6, the INIT entry will be 
executed, and if AUX1=7, the file will be loaded without 
executing either entry point. Any other values of AUXi will 
return an error code and do nothing. 


Another XIO call, XIO 34, has been added to create a 
directory. When a directory is created, the name used must not 
match any existing file or directory in its parent (for example 
if the directory to be created is named "Di:TEST: BUGS", there can 
be no other directory in the main directory named "TEST" nor a 
file named "TEST" there. 


From BASIC the XIO 34 call is "XIO 34, #iocb, 8, O, dirname" 
where "“iocb" is any available unit number, and "dirname" is the 
name of the new directory (with no trailing ':'). 

The final function added to those provided by ATARI DOS II 


is XIO 41, to define the default directory. The default 
directory is that which will be searched for a file if the file 


MYDOS 3.0 User Guide Revision 3.09 


i a nia i ig i oc eee 


a 


name begins with "D:". In ATARI DOS II this default directory is 
always "Di:" but in MYDOS 3.0, the default directory can be any 
root or subordinate directory on any disk in the system. The 
buffer address passed CIO in the XIO 41 call is the address of a 
string that contains the default directory name, terminated with 
either an end of line ($9B) or a null byte ($00). The directory 
will be accessed before returning to the calling program so that 
an error in specifying the directory will be reported as early as 
possible. 


6. CIO FUNCTION CODES PROVIDED BY MYDOS 3.0 


6.1 Function code 3, OPEN 


The open function uses the buffer address to point to an 
ATASCI string terminated with a character not 0-9, A-Z, a-z, :, 
?, or *. This string is the name of the file to be accessed or 
created. A good terminator for this string is either a null 
($00) or an end of line ($9B). 


The AUX1 byte defines the usage of the file: 4 for input, 6 
for directory data reading, 8 for creating/replacing output, 9 
for creating/appending output and 12 for input/update (without 
extension). The AUX2 byte is used when a file is replaced or 
created, and contains three significant bits, bit 1 set causes a 
DOS I format file to be created if the diskette is single sided, 
single density (otherwise, it is ignored). Bit 2 set causes. the 
MYDOS format to be used even if the diskette is a 40 track single 
sided diskette. And bit 6 set results in the file being lLOCKed 
initially without and additional CIO call. For input, update or 
directory access AUX2 is ignored, and the length is always 
ignored. In normal use, AUX2 is set to zero emulating ATARI DOS 
II usage. 


6.2 Function code 5, GET RECORD 


The get record function reads a line of data into a buffer, 
the buffer being defined by its starting address and length. The 
line is defined as the data bytes in the file up to an end of 
line character ($9B) or until the buffer is full, whichever 
occurs first. The line is also terminated if the end of the file 
is read. All record I/O is buffered in MYDOS so record transfers 
are necessarily slower than unbuffered I/O. 


No other fields of the IOCB are referenced or needed. Note 
that the ATARI ROM OS supports single byte I/O through the 
accumulator if the buffer length is set to 0. In this case, GET 
RECORD and GET CHARACTERS function exactly the same way. 
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6.3 Function code 7, GET CHARACTERS 


The get characters function reads a fixed number of bytes 
from a file into a buffer, the buffer being defined by its 
address and length (two 16-bit number in the ICCB). The only 
case where the buffer is not always filled is if the end of the 
file is read. As is the case with get record calls, a_ single 
byte may be read into the accumulator by setting the length field 
to zero. A get character CIO call will be perform unbuffered I/0 
if the buffer is longer than 256 bytes (ATARI DOS II sets a 
Similar threshold at 128 bytes). For this reason a single long 
input is considerably faster than several short ones. 


Only the buffer address and length in the IOCB are used by 
the get characters function. 


6.4 Function code 9, PUT RECORD 


The put record command will write a single line to an output 
file, the line defined the starting address of the buffer and 
either the length of the buffer if no end of line ($9B) bytes are 
encountered, or the first end of line byte. Only the buffer 
address and length in the IOCB are used in this command. 


6.5 Function code 11, PUT CHARACTERS 


The put characters command will write the contents of a 
buffer defined by its address and length (in the IOCB), to a file 
opened for output. The entire buffer is always written to the 
file unless the write is to an output/update file and the end of 
the file is reached or the write is to an output/append or create 
file and the last sector on the disk has already been allocated. 
Only the buffer address and length fields in the IOCB are used 
when the put character function is used. 


6.6 Function code 12, CLOSE A FILE 


To terminate use of a file (and for an output file, to write 
the incomplete buffer to the disk) the IOCB used to aecess the 
file should be closed. This is done by setting the function code 
in the IOCB to 12 and calling CIO. The close function does not 
use any of the data in the IOCB for any purpose whatsoever. 


6.7 Function code 13, READ STATUS 


The read status command is issued to an unopened IOCB, with 
the buffer address that of a file name string. If the file is 
not present that error condition is returned, if it is locked, 
that error condition is returned; otherwise, a normal completion 
code is returned. Only the function code and the buffer address 
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in the IOCB are needed. 
6.8 Function code 32, RENAME A FILE 


The rename function is passed a character string (pointed to 
by the buffer address in the IOCB), and the first part of the 
string is a file name string identifying the file or files to be 
renamed. Following a single invalid character (one invalid in 
the file name, that is) another file name must be in the string: 
this second file name cannot include any drive or directory 
names. An example, using a comma as the invalid character, is 
"D2: TEST: PGMS:A.OUT,ZCPY" which will change the string needed to 
access the file "D2:TEST:PGMS:A.OUT" to "D2:TEST:PGMS:ZCPY" —- 
Note that only the last file name (if subdirectories are used) 
can be changed, to change "PGMS" to "MLPROGS", the buffer must 
contain "D2:TEST:PGMS,MLPROGS" and the rename will also change 
the full names of all files in "D2:TEST:PGMS" (to belabor the 
obvious). f 


6.9 Function code 33, DELETE A FILE , 


The delete function removes any files that match the file 
name string pointed to by the buffer address in the IOCB. Files 
locked will not be deleted, so must be unlocked before being 
removed, and directories that are not empty (that have a file, 
even an empty file, in them) cannot be deleted. If either case 
is attempted, the corresponding error code is returned. 
Otherwise, the files are removed and their data areas are 
returned to the free space on the disk. Like other Atari DOSs, 
in MYDOS files removed cannot be recovered after being deleted. 
This is unlike some other operating systems that preserve deleted 
files for as long as practical before overwriting then. 


6.10 Function code 34, MAKE DIRECTORY 


The make directory function will create a new subdirectory 
on a disk (it is not used to create the first directory, that is 
the “root directory" identified by the drive specification "D1i:", 
for example). It is called through CIO by storing the address of 
the new directory's name in the IOCB buffer address and setting 
up AUX1 and AUX2 as for an open call (see Function code 3), 
normally AUX1=8 and AUX2=0O. This function has no effect on the 
current default directory, and if it is desired to make the newly 
created directory the default one, the program must make a set 
directory call (Function code 41) following the make directory 
call (the order is very important, because the default directory 
cannot be set to a nonexistent directory). 
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6.11 Function code 35, LOCK FILE 


A file can be "locked" so that it may not be modified or 
deleted inadvertently by calling CIO with the lock function. The 
buffer address is used to point to a file name string that 
identifies the files on the disk to be locked. The only file 
modification that can be performed on a locked file is to unlock 
ibs The lock function can be requested for a file already 
locked, and it will return no error (unlike other file 
modification calls to CIO), but the status of the file will not 
have been changed either. 


6.12 Function code 36, UNLOCK FILE 


The unlock function is identical to the lock function except 
that is reenables the modification or deletion of an unlocked 
file. A file that is not locked can be unlocked with no error 
returned and no change in the file's status. 


6.13 Function code 37, POINT TO POSITION IN FILE 


The point function is passed the 3-byte disk address to be 
positioned to in the twelvth through fourteenth bytes of the 
IOCB. On return, the next byte read from that IOCB will be the 
one that was read or written next after the corresponding note 
function was executed. A point call to CIO can only be made if 
the file can be used for input: that is, if it is opened for 
input or update processing. 


6.14 Function code 38, NOTE POSITION IN FILE 


The note function returns in the twelvth through fourteenth 
bytes of the I0CB a 3-byte disk address that may be used at a 
later time to reposition the file using the point function. The 
note function can be used on files open for input, output, update 
or appending. 


6.15 Function code 39, LOAD MEMORY 


The load memory function takes a file formatted in the ATARI 
DOS II executable program format (generated by the "K" command, 
by the assembler/editor cartridge, by AMAC or MAC65, or by any of 
several compilers for the ATARI computers) and loads its contents 
into the computer's memory as specified in the file. No offset 
control is provided and no part of memory is protected from the 
loading process. The initialization and execution addresses (if 
any) can be individually enabled and disabled, however, to permit 
loading and patching a program then writing it back to the disk 
for normal use. 
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To load a program into memory, the address of the file name 
String is stored into the buffer address and a value of 4, 5, 6 
or 7 is stored into the AUX1 field. Ef AUR ce 42° Beth “the 
initialization routines and the run address are executed after 
closing the IOCB used but before returning to the calling 
program. If AUX1 is 5, the initialization routines are disabled, 
but the program will be run. If AUX1 is 6, the initialization 
routines will be run, but the program execute address will be 
loaded and ignored. If AUX1 is 7, the text of the program will 
be loaded into memory, but no other activity will be performed. 


6.16 Function code 41, SET DEFAULT DIRECTORY 


The set directory command will use the contents of the 
buffer as a file name and open the specified file, determining if 
that file is a valid directory. If so, it will become the new 
default directory. That is, file names of the form "D:..." will 
be assumed to be in the deafault directory (which may be on any 
disk in the system and may be either the root directory of that 
disk or a subdirectory). , 


Only the buffer address and the function code are 
Significant when setting the default directory. 


6.17 Function code 254, FORMAT A DISKETTE 


The format function uses the contents of the buffer pointed 
to by the buffer address to identify the drive containing the 
diskette to be formatted. If both AUX1 and AUX2 are zero, the 
disk is formatted according to the capacity data in the system 
control table defined using the 'O' command. If AUX2 bit 7 is 
set to 1, the format operation is skipped and an empty file 
system is written to the diskette. The remaining 15 bits of AUX1 
and AUX2 are used as a 15 bit number to specify the number of 
sectors available on the disk (permitting the use of the last few 
sectors of a disk outside the file system if desired). 


7- DISK STRUCTURES SUPPORTING MYDOS 3.0 


MYDOS 3.0 uses the first three sectors of a disk to hold 
some disk information and the initial boot program if the drive 
contains DOS.SYS and Dup.SYS. Sector $168 (and sector $167 if 
the disk is formatted as a high capacity disk) is used to hold a 
bit map of available sectors and several flag byte identifying 
the default format of files on the disk. Sectors $169 through 
$170 contain main disk directory data, identifying the files on 
the disk, their sizes and their starting sector number. 


Note that this usage, when the disk is declared to be DOS II 
compatible, is in fact exactly the same as ATARI DOS II would 
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make of the disk. The only significant change made when the high 
capacity format is chosen are that sector $167 is also reserved 
for use by the system. The high capacity disk directory may be 
read by ATARI DOS II, but the data in the files can only be 
accessed if it falls in the first 1023 sectors of the disk and 
then only if the file number checking code in DOS II is disabled. 
This format and MYDOS 3.0 support accessing disks of up to 4015 
sectors of 256 bytes each. 


Compatibility is further reduced if subdirectories are used: 
to ATARI DOS 2.0, the subdirectories will appear to be simple 
files with unreadable contents. The subdirectory's files will 
not be accessable and the subdirectory can be damaged if it is 
written to (even by appending). For this reason disks sold to 
the general public, exchanged with friends, and so forth, should 
not contain subdirectories unless there is reason to require that 
the disk be used with MYDOS. A further problem with exchanging 
diskettes is that each vendor of double sided disk systems for 
the ATARI is using a different format for the second side -- for 
this reason, double sided disks no only require both computers 
use MYDOS, but also require that they use the same disk system 
(PERCOM, SWP, or RANA). 


8. MYDOS 3.0 MEMORY MAP 


The MYDOS 3.0 disk operating system occupies the area from 
$0700 to $1C80 at all times, and when the menu is active, it also 
occupies the area from $1C80 to $3300. In addition, the first 16 
bytes of the floating point workspace ($D4 - $E3) are used by 
MYDOS 3.0 at that time. Unlike ATARI DOS II, MYDOS 3.0 also calls 
the floating point ROM entry points. 


9. ROMDOS 3.0 MEMORY MAP 


The ROMDOS 3.0 disk operating system occupies the area from 
$0700 to $O0BEO at all times, and when the menu is active it also 
occupies the area from $OBEO to $2000. As does MYDOS 3.0, it uses 
the floating point ROM entry points and 16 bytes of the floating 
point ROM workspace from $D4 to $E3. 


10. CUSTOMIZING A SYSTEM DISK 


10.1 Number of Files Open at Once 


The number of files that may be simultaneously open is set 
with the same byte as in ATARI DOS II: location $0709 (decimal 
1801). This byte contains a number from O to 16 setting the 
number of disk files that may be open at the same time. Normally 
it is set to 3, the smallest number that supports all the 
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functions in the MYDOS 3.0 menu. Specifically, a copy from one 
disk file to another requires three open disk files. The value 
in the distributed version of MYDOS 3.0 is three, to permit more 
or fewer files, use the "0" command followed by a RETURN. You 
can also "poke" the value desired into location $0709 and press 
the RESET key. To permanently change the maximum number of 
files, use the 'H' command to write a modified MYDOS 3.0 system 
to a disk. 





10.2 Controlling the Disk Drives Accessed by MYDOS 3.0 


Like ATARI DOS II, MYDOS 3.0 automatically identifies the 
disk drives that are present when booted up initially and any 
time it is reinitialized (some programs do this on exiting to the 
DOS and it is always done if the RESET key is pressed. MYDOS 3.0 
is distributed with drives 1 and 2 configured, all others are 
omitted in order to speed up the booting process. To modify the 
maximum configuration MYDOS 3.0 will use, invoke the 'O' command 
for each drive to be added to (or removed from) the system. 
Pressing the RESET key will then use this value to redefine the 
system. To permanently change the maximum drive configuration, 
use the 'H' command, writing a new copy of MYDOS 3.0 back to the 
system disk. 


10.3 Selecting or Disabling Write-with-Verify 


MYDOS 3.0 is distributed with all data written to the disk 
read back to verify that it was not only written to the diskette 
correctly, but that there was not a problem (dust, a scratch in 
the oxide coating, or some other problem that may have arisen 
since the diskette was formatted) that prevented the data from 
being read back from the diskette. If the programs being run 
have no long term value (games for example, often write daily 
high scores to the disk, and loss of such data might result in a 
few screams or moans, but so does waiting for a slow update of 
the scores after each game!). 


The byte at location $0779 (1913 decimal) controls all write 
operations to the disk. If the value 'poked' into it is $57 (87 
decimal), than all writes will be read back to verify the action 
was successful. If the value 'poked' into $0779 is $50 (80 
decimal) then writes will be assumed successful, and will 
normally be performed in about one third the normal amount of 
time. This byte is defined, along with the count of the number 
of buffers to be allocated when the file manager is initialized, 
whenever the '0O' command is invoked with no drive specified (only 
a RETURN is entered in response to the drive number query). To 
permanently alter it, rewrite MYDOS back to thé disk using the 
'H' command after changing it. 
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11. DISK DRIVE INTERFACE (vie SIO) 


The physical disk drives and diskettes are external to the 
ATARI home computers and the ones supported by MYDOS 3.0 are 
normally attached to the "serial interface connector" on the 
right side of the computer. The software in the operating system 
(OS ROMs) to access the devices attached to that connector is 
call the "serial I/O driver" or SIO for short. The MYDOS 3.0 
disk operating system uses this lower level driver to pass all 
commands and information to and from the physical disk drive. 
Several commands were defined by ATARI to communicate with the 
810 disk drive and both PERCOM and Software Publishers, Inc., 
have adopted a slightly extended version of this set of commands. 
MYDOS 3.0 will operate in a limited fashion with any disk system 
that supports the entire 810 set, but the full set of commands is 
required to support all the functions. 


The minimum set.of disk drive functions to support MYDOS 3.0 
(or ATARI DOS II for that matter) are: 


Device Unit Command Direction Byte Ct. Aux. Bytes Function 
$31 Drive# $21 From Drive 128/256 to 720 FORMAT DISK 
$31 Drive# $50 fo Drive 128/256 to 720 WRITE(no vfy) 
$31 Drive# $52 From Drive 128/256 to 720 READ 
$31 Drive# $53 From Drive 4 to 720 READ STATUS 
$31 Drive# $57 To Drive 128/256 to 720 WRITE(verify) 


eo 


The byte count is always 128 for a small sector drive, and is 128 
for the first three sectors (1, 2, and 3) of a large sector 
drive. All other sectors on a large sector drive are 256 bytes 
long. 


The FORMAT function is never called with a sector number not in 
the range of 4 to 720. It expects 128 bytes from a small sector 
drive and 256 bytes from a large sector drive. 


The first byte returned by the READ STATUS command is expected to 
indicate the sector size -- if bit 5 is a1 (bit 7 is the sign 
bit) then the sectors are large (256 bytes), otherwise, they are 
small (128 bytes). 


The auxiliary bytes are treated as an address to a sector on the 
diskette, and range from 1 to 720 (when in DOS II compatible 
mode) or from 1 to 4015 (when accessing large capacity disk 
drives). 
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The additional functions used to configure disk drives dynamically 
are: 


Device Unit Command Direction Byte Ct. Aux. Bytes Function 


$31 Drive# $4E From Drive 12 1 to 720 READ CFG. 
$31 Drive# $4F To Drive 12 1 to 720 WRITE CFG. 
These commands support the ‘Ft command, permitting 


reconfiguration of a disk drive on demand: to format a diskette, 
for example. 


These commands support identification of a disk drive as an 8 
inch or double sided drive as well. The individual bytes are 
defined as follows: 


byte 0: Tracks per side (40 for a standard disk drive) 
byte 1: Disk Drive Step Rate (as defined by Western Digital) 
byte 2: Zero (high byte of sectors/track) 
byte 3: Sectors/Track (18 for standard diskettes) 
byte 4: Side Code (O=single sided,. 1=double sided) 
byte 5: Disk Type Code -- 

bit 2: O=single density, i=double density 

bit 1: O=5 1/4 inch diskette, 1=8 inch diskette drive 
byte 6: High byte of Bytes/Sector (O for ATARI 810 compatible) 
byte 7: Low byte of Bytes/Sector (128 for ATARI 810) 
byte 8: Translation control 


bit 7: 1=40 trk. disk I/O on an 80 trk. drive 

bit 6: Always 1 (to indicate drive present) 

bit 1: 1=Handle sectors 1, 2, and 3 as full size sectors 

bit O: 1=Sectors number 0-17 (for example) not 1-18 
bytes 9-11 are not used (and should be zero) 


An additional requirement is that the disk drive automatically 
switch density if required to read sector 1. This is necessary if 
one is to 'boot' either single or double density disks and is 
used by the MYDOS 3.0 system to automatically set the drive 
density from the menu handler. 
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12. Error Codes and Sources 
3 Last byte of file read, next read will return EOF (MYDOS) 

128 Break Abort (OS ROMs) 

129 IOCB already open (OS ROMs). 

130 No such device defined in the system (OS ROMs) 

131 Write-only IOCB, cannot read (OS ROMs) 

132 Invalid command (OS ROMs) 

133 Device or File not open (OS ROMs) 

134 Invalid IOCB reference (OS ROMs) 

135 Read-only IOCB, cannot write (OS ROMs) 

136 Attempt to read past end of file (MYDOS) 

+37 Truncated record (OS ROMs) 

138 Device Timeout (OS ROMs) 

139 Device NAK (serial bus failure, OS ROMs) 

141 Cursor out of range for graphics mode (OS ROMs) 

142 Data frame overrun (serial bus failure, OS ROMs) 

143 Data frame checksum error (serial bus failure, OS ROMs) 

144 Device I/O error (in peripheral hardware, OS ROMs) 

146 Function not provided by handler (OS ROMs) 

147 Insufficient RAM for graphics mode selected (OS ROMs) 

160 Invalid Unit/Drive Number, zero or greater than 8 (MYDOS, OS ROMs) 

161 No sector buffer available, too many open files (MYDOS) 

162 Disk full, cannot allocate space for output file (MYDOS) 

163 Not used: Atari DOS II system I/O error code 

164 File number in link does not match directory location (MYDOS) 

165 Invalid file name (MYDOS) 

166 Byte not within file, invalid POINT request (MYDOS) 

167 File locked, cannot be altered (MYDOS) 

168 Invalid IOCB (MYDOS, OS ROMs) 

169 Directory full, cannot create a 65-th entry in a directory (MYDOS) 

170 File not in directory, cannot be opened for input (MYDOS) 

171 IOCB not open (MYDOS, OS ROMs) 

172* File or directory of same name already exists, cannot create (MYDO} 

173 Bad diskette or drive, cannot format diskette (MYDOS) 

174* Directory not in parent directory (MYDOS) 

175* Directory not empty, cannot delete (MYDOS) 

180* Invalid file structure for loading memory (MYDOS) 

181* Invalid address range for loading memory, END<BEGIN (MYDOS) 

* -- New error codes, not present or different in Atari DOS II. 
Most error codes are identical to those returned from ATARI 

DOS II, the differences result from the expanded capabilities of 


MYDOS 3.0. Specifically, Error 164, indicating a file number 
mismatch, only occurs if the file is written in DOS II or ATARI 
DOS I format. Errors 180 and 181 can only occur when XIO0 39 is 


invoked 


to load a file, the ATARI DOS II equivalent function 


returned a code in the X-register. Errors 172 and 175 apply to 
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creating and deleting directories and have no ATARI DOS II 
equivalent. And Error 174 applies to accessing files in 
subdirectories, so it also has no ATARI DOS II equivalent. Error 
code 173 serves the same function as it did in ATARI DOS II, but 
is returned more often (to identify bad diskettes more reliably). 
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1. The ATR8000 Serial I/O Handler 


This document is an appendix to the MYDOS 3.0 User Guide and 
is not intended to be used alone. It describes the functions 
provided by MYDOS 3.1 that are not provided users of MYDOS 3.0. 
One significant difference is the fact that MYDOS 3.1 occupies 
memory up to address $2100 and the utility or menu program 
extends to $3800. 


1.1 Programming Serial I/0 Activity 


When MYDOS 3.1 is booted, the RS232 serial port handler and 
the disk I/O handler are linked into the Central I/0 (CIO) 
tables. The disk I/O handler is accessed using the CIO function 
calls described in section 6. Those used to access the RS232 
serial port handler are described in following subsections. As 
with the ATARI 810 and 850 peripheral devices, the disks are 
refered to when the device name begins with "D" and the _ serial 
port is refered to when the name begins with "R". 


Most programs written for use with the ATARI 850 interface 
will function properly with the ATR8000 and MYDOS 3.1. There are 
several limitations to this compatibility, however. Software on 
protected diskettes will not usually run because it cannot be run 
with MYDOS 3.1 (it will contain its own disk and RS232 1/0 
routines). Programs that use two or more serial ports of the 850 
will not run because the ATR8000 has only one such _ port. (It 
may, however, be used as any one of the four ports though.) The 
status returned by the MYDOS 3.1 serial handler is somewhat 
different from that returned by the ATARI 850 handler as a result 
of the differences in the control lines provided by the ATR8000 
and the inability of the MYDOS 3.1 serial driver to handle block 
mode output. MYDOS 3.1 also does not support 5, Ber’ T= ay 
serial data so programs that use Baudot or Correspondence codes 
will not run properly. Lastly, the transmit and receive buffers 
used by the MYDOS 3.1 serial handler cannot be replaced by user 
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supplied ones: if the program provides its own buffers they will 
be ignored. The dedicated buffers are each 256 bytes long. 


Use of the serial port will also interfere with the 
operation of the disk I/O timeout and the printer spooling 
activities. While concurrent I/0 is enabled, the printer will 
not print any text in the spooler buffer and the disk will be 
turned off immediately. When the serial port is closed, printing 
will be resumed (with no lost data) and, of course, disks may 
again be accessed. 


1.2 Function code 3, OPEN RS232 PORT 


This function uses the AUX1 byte and the buffer address 
(pointing to the device name: 'R:'). The values permitted for 
the AUX1 byte are 0-15: if bit 2 is on, input is permitted, if 
bit 3 is on, output is permitted. Bits O and 1 are ignored. 
Bits 6 and 7 must be.zero. Opening the RS232 port does not 
activate concurrent I/O or transfer any data over the serial bus 
(it is entirely internal to the computer). 


1.3 Function code 5, GET RECORD 


The get record function transfers data from the input buffer 
to the buffer pointed to by the buffer address in the IOCB until 
an EOL character is transferred (if translation is active this is 
an external CR character). In no case, however, will more than 
the number of bytes in the length field of the IOCB be 
transferred. 


1.4 Function code 7, GET CHARACTERS 


The get characters function is identical to the get record 
function except that the EOL or CR character is ignored. The 
call will always transfer the number of bytes specified by the 
length field. 


1.5 Function code 9, PUT RECORD 


The put record will transfer the number of byte specified by 
the length field or until an EOL character is encountered in the 
puffer pointed to by the buffer address in the 10CB. The data is 
moved to the RS232 buffer and if sufficient room is available to 
contain the record the calling program will continue executing 
before the data is actually transmitted. 
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1.6 Funetion code 11, PUT CHARACTERS 


The put characters function transfers the number of bytes 
specified by the length field in the IOCB from the buffer pointed 
to by the buffer address into the transmit buffer in the handler. 
Except that it treats EOL characters as it does all others, the 
put characters function is identical to the put record function. 


1 «Loa Banction.code 1:2:, CLOSE -RS232—PORT 


Issuing the close function call to the RS232 serial port 
handler will cause the calling program to wait til all text in 
the transmit buffer is transmitted, then it disables concurrent 
I/O activity, marks the IOCB free, and flushes (throws away) the 
data in the input buffer. This is the only 850 compatible way to 
terminate concurrent I/0. 


1.8 Function code 13, READ STATUS 
The read status command may be issued when concurrent I/O is 


active and when it is not. If concurrent 1/0 is inactive, two 
bytes of status are returned: the first is defined as follows: 


Bit Value Meaning 

7 128 Data framing error (RX) 

6 64 Data byte overrun (RX) 

5 32 Data byte parity error (RX) 
4 16 Receive data buffer overrun 
2 4 CD not ready 


The second byte is defined according to the following table. 


Bit Value Meaning 

6,7 192 Ring indicate (pin 22) is on 
2-5 60 Carrier detect (pin 8) is on 
0,1 5 Data in is high (pin 3) 


If the concurrent I/O is active on the channel, three data 
bytes are returned: the first is the same as before, the second 
is number of bytes in the receive buffer awaiting processing. 
The third byte is always zero and the fourth is the number of 
bytes in the transmit buffer waiting to be sent over the _ serial 
channel. 
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1.9 Function code 34, CONTROL SERIAL PORT OUTPUTS 


The two lines in the RS232 serial port controlled by the 
ATR8000 are under direct program control using the control 
outputs function. The IOCB may be a free one or it may be opened 
to the serial handler but if concurrent I/0 is active, only the 
data out line can be altered. In either case, only the AUX1 byte 
is used by the handler. Bit 7 or bit 5 enable changing the DTR 
control line and bit 1 enables changing the data out (TD) line. 
Bits 6, 4 and O are the corresponding values to set the line to. 


1.10 Function code 36, SET BAUD RATE AND CONFIGURE 


The baud rate, number of stop bits, and control of status 
line checking are set using the CIO function 36. In this 
function, bit 7 of AUX1 on results in transmitting 2 stop bits 
per byte (off results in one stop bit). Bits 4, 5 and 6 should 
be zero and bits 3-O.set the baud rate according to the following 
table: 


Bits 3-0 Bits/Second 
O 0000 300 

1 0001 455 

2 0010 50 

4 0011 56.875 
4 0100 75 

5 0101 110 

6 0110 134.5 

7 0111 150 

8 1000 300 

9 1001 600 

10 1010 1200 
11 1011 * 1800 
12 1100 2400 
1:5 1101 4800 
14 1110 9600 
15 wae 9600 


If AUX2 is zero, the CD input line is not required before 
starting concurrent 1/0. If AUX2 is between 1 and 7, CD must be 
on before any I/O may be inituated. 


1.11 Function code 38, SET TRANSLATION AND PARITY 


The contents of the AUX1 byte are interpreted according to 
the following tables to set translation modes and to control 
outgoing parity. It also controls the interpretation of incoming 
parity bits (bit 7 of each byte). The contents of AUX2 are 
substituted for any untranslatable byte if heavy translation is 
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Value to Add Means: 

Do not append LF after CR 
Append LF to each CR 

Translate EOL($9B) to CR 

and zero bit 7 

Also convert $00-$1F to AUX2 

Do no translation 

Ignore and do not change parity 
Check for odd parity and clear 
Check for even parity and clear 
Ignore parity and clear it 

Do not change bit 7 (output) 
Set output parity odd 

Set output parity even 

Set output bit 7 to 1 
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1.12 Function code 40, ENTER CONCURRENT I/O MODE 


This function enables the serial I/O port handler and starts 
up the buffer handling routines. Unlike the ATARI 850 function, 
it cannot be used to specify an alternate input buffer. Also, 
unlike the ATARI 850 function, it need not be specified at all: 
the first read or write accessing the open port will 
automatically enter concurrent mode I/O. 


Also different from the ATARI 850, concurrent mode I/0 use 
of the bus will terminate on any standard CIO bus transaction. 
This will leave the handler ina state of disrepair, but the 
contents of RAM can be written to disk or otherwise salvaged. 


Because this function is not required to start an input 
function, the BASIC 'ENTER' and 'LOAD' functions can be used with 
the ATR8000 serial port. As with the ATARI 850, BASIC's 'LIST', 
'SAVE' and 'LPRINT' can also be used. 
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